home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1996 April / MacFormat CD Edition MF36 (April 1996).iso / Floppy / MacFormat Floppy Archive / MacFormat 27 / Rotater-2.7 / README 2.7 < prev    next >
Text File  |  1995-04-17  |  7KB  |  234 lines
  1. Rotater 2.7
  2. ===========
  3. This is a program that reads a set of 3-dimensional points
  4. and lines and plots them in a window. The image can then
  5. be rotated with the mouse in real time.
  6.  
  7. Requires System 7 or greater.
  8. 8 bit colour screen and Power Macintosh preferable.
  9.  
  10.  
  11. Versions
  12. --------
  13. Rotater-FAT-2.7
  14. A fat binary for PowerMacs and 68K Macs
  15.  
  16. Rotater-881-2.7
  17. A binary for 68K Macs with an FPU
  18. Will not run on a PowerMac or a 68K Mac with no FPU
  19.  
  20.  
  21. Changes from 2.0
  22. ----------------
  23. A new icon :-)
  24. faster!
  25. Can now have a white background in 3D-Glasses Mode.
  26. Recompiled with CW5 - slightly faster again.
  27. New folder icon :-)
  28. Floating Info Windows.
  29. New folder icon for rotater files :-)
  30. Can now center object on the screen
  31. Reads in large files more than 20 times faster
  32. Muchly speeded up (esp. small windows)
  33. Better default positions
  34. Better zooming of fast images
  35. Added Funky mode
  36. Can now set Max window size
  37.  
  38.  
  39. Help
  40. ----
  41. The program has balloon help for all of the menu items.
  42.  
  43.  
  44. Maximum Window Size
  45. -------------------
  46. You can now set the maximum window size that the program
  47. can use. This can be done by holding down the option key
  48. on startup. The selected size is saved for future sessions.
  49.  
  50. Larger windows require more memory to run so set the Max
  51. size to as small as possible if you need to conserve
  52. memory. You will also need to adjust the minimum and
  53. prefered memory sizes in Rotater's Get Info... box
  54. from the Finder.
  55.  
  56. If you cannot open the program because you have set the
  57. Max window size too high for available memory use the
  58. option key at startup to set a smaller window size.
  59.  
  60.  
  61. Rotation Method
  62. ---------------
  63. Click on the image and hold the mouse button down. Moving the
  64. mouse now rotates the image.
  65.  
  66. The track-ball rotation method is used to rotate the image.
  67. Imagine the image is inside a clear ball. Dragging the mouse
  68. across it is like rolling the ball. Try it and see :-)
  69.  
  70. If you have the Grab & Spin option set under the action menu,
  71. when you let go of the mouse button while still moving the mouse
  72. the image will continue to rotate in the same direction.
  73. Stop all rotation by clicking the mouse once. You may need to
  74. hold the mouse button down for a while on slow machines.
  75.  
  76. Drag & Spin will not work if the image takes longer than 1/4 of a
  77. second to calculate and draw. Copying to very large windows slows
  78. the program down considerably.
  79.  
  80.  
  81. Keyboard Rotations
  82. ------------------
  83. The "x", "y" and "z" keys rotate about their respective axes. By
  84. holding the shift key down when using them, the image will rotate
  85. in the opposite direction. The arrow keys can also be used for
  86. rotating the image.
  87.  
  88. The 'x' axis runs left and right across the window, 'z' runs up
  89. and down the screen and 'y' runs into and out of the screen.
  90.  
  91.  
  92. Resizing the Viewing Window
  93. ---------------------------
  94. The viewing window can be resized using an invisible handle on
  95. the bottom right corner of the window.
  96.  
  97. Maximum window size is full screen on a 16" monitor.
  98.  
  99. Square windows are optimal in normal mode. Windows twice as
  100. wide as they are high are optimal for stereo mode.
  101.  
  102. Smaller windows run faster.
  103.  
  104.  
  105. Saving Images
  106. -------------
  107. Images can be saved to disk either as a 72 dot per inch
  108. bitmap or as 300 dpi Vector picture that can be edited and
  109. printed from draw type programs. Note that there is an upper
  110. limit for the number of elements that can be saved in vector
  111. format somewhere around 20,000.
  112.  
  113. Note that files saved at 300dpi have joins at 72dpi intervals
  114. when imported to some programs. I dont know how to fix this.
  115.  
  116.  
  117. Maximum Number of Points/Lines
  118. ------------------------------
  119. The default memory allocation for the program should be enough to
  120. read about 20000 points or lines in. To increase this number,
  121. increase the memory allocation in the programs "Get Info" box.
  122.  
  123. You will receive a warning if you try to read in a file that is
  124. too large for available memory.
  125.  
  126.  
  127. Speed of Rotating
  128. -----------------
  129. Smaller windows run faster.
  130.  
  131. Hiding lines slows the program down especially on non-PPC machines.
  132.  
  133. Thinner lines and smaller dots run faster.
  134.  
  135. Make sure your monitor is in 8-bit mode with the System colour
  136. palette for maximum speed.
  137.  
  138. This program runs VERY VERY much faster on a Power Macintosh than
  139. on a 68K Macintosh (about 10 times faster!).
  140.  
  141. Points plot faster than lines. 20000 points can be
  142. comfortably manipulated on a Power Macintosh 6100/60.
  143.  
  144.  
  145. Format of the Input File
  146. ------------------------
  147. The input file consists of sets of four points on each line
  148.  
  149. x y z c
  150.  
  151. x = x coordinate of a point (real)
  152. y = y coordinate of a point (real)
  153. z = z coordinate of a point (real)
  154. c = colour and/or drawing method (integer)
  155.  
  156. if (c = 0) move to the x,y,z point without drawing
  157. if (c > 0) draw a line to the x,y,z point from the current
  158.            position using colour c
  159. if (c < 0) draw a dot at x,y,z using colour -c
  160.  
  161. where
  162. if (c = 1) colour is red
  163. if (c = 2) colour is green
  164. if (c = 3) colour is blue
  165. if (c = 4) colour is yellow
  166. if (c = 5) colour is purple
  167. if (c = 6) colour is cyan
  168. if (c > 6) colour is white
  169.  
  170. eg
  171. 0.5 2.3 -1 0  # moves to point 0.5 2.3 -1 without drawing
  172. 3 5 6 2       # draws red line from 0.05 2.3 -1 to 3 5 6
  173. 5 -5 2 -3     # plots blue dot at 5 -5 2
  174.  
  175. The points are automatically scaled to fit in the window and
  176. rotation is about 0,0,0.
  177.  
  178. The input file can be any text file.
  179. # Comment lines begin with the '#' character.
  180. Text after the four points on a line is ignored.
  181. Completely blank lines are ok (they are ignored).
  182.  
  183. Contiguous comments at the very start of the file are read in
  184. and displayed in the program in the Info window.
  185. Use this to explain to the user what the image is and where
  186. it comes from. Try to keep it short otherwise the window gets
  187. too big. Internal documentation can be placed in other
  188. comments after a blank line.
  189.  
  190.  
  191. Notes
  192. -----
  193. This program is free and I take no responsibility if it kills
  194. your machine or drives you mad. Use at your own risk.
  195.  
  196. It may not be sold.
  197.  
  198. Source code and project files for the Metrowerks CW5 compilers
  199. are available at the archive site or on request.
  200.  
  201. E-mail me if you find a use for this program or come up with a
  202. cool set of points/lines worth adding to the collection.
  203.  
  204. The official Archive site for source code, new updates,
  205. rotation files etc is:
  206.   ftp://raru.adelaide.edu.au/rotater/
  207. or
  208.   http://raru.adelaide.edu.au/rotater/
  209.  
  210.  
  211. Thanks To
  212. ---------
  213. Thanks go to the following:
  214.  
  215. Metrowerks for a great compiler.
  216. Toby Thain and Dale Greer for help speeding up the program.
  217. Andrew Maloney for speed and floating window help.
  218. Tim Olson for bzero.
  219. David Doak, Charles Williams and E.J. Chichilnisky
  220.  for many helpful suggestions.
  221. Richard Chipper for the new icons.
  222. Troy Gaul for the Infinity Windoid WDEF.
  223. Patrick Rabou for help speeding up file reading and ball plotting.
  224. Brent Stone for heaps of cool speed optimizations.
  225.  
  226. Numerous people for rotation files (see comments in the files)
  227.  
  228.  
  229. Enjoy
  230.  
  231. Craig Kloeden
  232. craig@raru.adelaide.edu.au
  233. 17 April 1995
  234.